ποΈGitΠ―ΡΠ°ποΈ
docs/srp/user/settings-radio-user.md renovate/datadog.gradle (516ec674) Text, 42.63 KB
title: Settings β Radio & User
parent: User Guide
nav_order: 7
last_updated: 2026-09-04
description: Configure your radio hardware, LoRa presets, user profile, position sharing, power management, and security.
aliases:
β’ ΠΏΠΎΠ΄Π΅ΡΠ°Π²Π°ΡΠ°
β’ radio-config
β’ user-config
β’ lora
Settings β Radio & User
Configure your radio's user identity, region and LoRa parameters, position and power behavior, network and Bluetooth connectivity, and security settings.
How These Screens Work
Everything here is on the Settings screen. User, LoRa, Channels and Security are
listed there directly. Device, Position, Power, Network, Display and
Bluetooth are one level down, under Settings β Device configuration. Network appears
only on radios with Wi-Fi or Ethernet, and Bluetooth only on radios with Bluetooth.
Settings use standard preference controls β dropdowns, toggles, and sliders:
ββββββββββββ¬ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Control β Screenshot β
ββββββββββββΌββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β Dropdown β !A dropdown setting, expanded to show its list of options and choose
Update status. Older firmware and a disconnected radio have no shortcut β the field above is
still the way in.
Configuration
ΠΠΎΠ΄Π΅ΡΠ°Π²Π°ΡΠ° ΡΡΠ΅ΡΠ°ΡΠ°
On Settings β Device configuration β Device.
ββββββββββββββββββββββββββββββββββββββββββ¬ββββββββββββββββββββββββββββββββββββββββββ¬ββββββββββββββββ
β Setting β ΠΠΏΠΈΡ β ΠΠΎΠ΄ΡΠ°Π·ΡΠΌΠ΅Π²Π°Π½ΠΎ β
ββββββββββββββββββββββββββββββββββββββββββΌββββββββββββββββββββββββββββββββββββββββββΌββββββββββββββββ€
β Π£Π»ΠΎΠ³Π° ΡΡΠ΅ΡΠ°ΡΠ° β Node behavior. The picker lists the fiβ¦ β T383838CLIENT β
β Π Π΅ΠΆΠΈΠΌ ΡΠ΅Π΅ΠΌΠΈΡΠΎΠ²Π°ΡΠ° β How the node retransmits messages. As β¦ β T383838ALL β
β ΠΠ½ΡΠ΅ΡΠ²Π°Π» Π΅ΠΌΠΈΡΠΎΠ²Π°ΡΠ° ΠΈΠ½ΡΠΎΡΠΌΠ°ΡΠΈΡΠ° ΠΎ ΡΠ²ΠΎΡΡ β How often the node re-announces itselfβ¦ β 3 hours β
β ΠΠ²ΠΎΡΡΡΡΠΊΠΈ Π΄ΠΎΠ΄ΠΈΡ ΠΊΠ°ΠΎ Π΄ΡΠ³ΠΌΠ΅ β Treat a double tap as a button press β ΠΠ½Π΅ΠΌΠΎΠ³ΡΡΠ΅Π½ΠΎ β
β Π’ΡΠΎΡΡΡΡΠΊΠΈ ΠΊΠ»ΠΈΠΊ Π·Π° Ad Hoc ΠΏΠΈΠ½Π³ β Send an ad-hoc position ping on a tripβ¦ β ΠΠ½Π΅ΠΌΠΎΠ³ΡΡΠ΅Π½ΠΎ β
β LED ΡΡΡΠ°Π½ΠΈ ΠΎΡΠΊΡΡΠ°ΡΠΈ β Blink the status LED periodically β ΠΠΌΠΎΠ³ΡΡΠ΅Π½ΠΎ β
β ΠΡΠ΅ΠΌΠ΅Π½ΡΠΊΠ° Π·ΠΎΠ½Π° β POSIX time-zone string for the device β¦ β β β
β Button / Buzzer GPIO β Advanced: which pins the button and buβ¦ β β β
ββββββββββββββββββββββββββββββββββββββββββ΄ββββββββββββββββββββββββββββββββββββββββββ΄ββββββββββββββββ
LoRA ΠΏΠΎΠ΄Π΅ΡΠ°Π²Π°ΡΠ°
On Settings β LoRa.
ββββββββββββββββββββββββββββββββββββ¬βββββββββββββββ¬βββββββββββββββββββββββββββββββββββββββββββββββββ
β Setting β ΠΠΏΠΈΡ β ΠΠΎΠ΄ΡΠ°Π·ΡΠΌΠ΅Π²Π°Π½ΠΎ β
ββββββββββββββββββββββββββββββββββββΌβββββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββββββββ€
β Π Π΅Π³ΠΈΠΎΠ½ β Regulatory β¦ β Unset (must configure) β
β Π£Π½Π°ΠΏΡΠ΅Π΄ ΠΏΠΎΠ΄Π΅ΡΠ΅Π½ΠΎ β Speed/rangeβ¦ β LongFast β
β Number of Hops β Maximum retβ¦ β 3 β
β Transmit Power β Transmissioβ¦ β 0 (region max) β
β ΠΠ·ΠΌΠ΅Π½Π° ΡΡΠ΅ΠΊΠ²Π΅Π½ΡΠΈΡΠ΅ β Overrides tβ¦ β 0 (use calculated) β
β ΠΠΎΡΠΈΡΡΠΈ ΠΏΡΠ΅Π΄Π΅ΡΠΈΠ½ΠΈΡΠ°Π½ΠΎ ΠΏΠΎΠ΄Π΅ΡΠ°Π²Π°ΡΠ΅ β On by defauβ¦ β On β
β Π€Π°ΠΊΡΠΎΡ ΡΠΈΡΠ΅ΡΠ° β Manual modeβ¦ β From preset β
β Π‘ΡΠΎΠΏΠ° ΠΊΠΎΠ΄ΠΈΡΠ°ΡΠ° β Manual modeβ¦ β From preset β
β ΠΡΠΎΡΠΎΠΊ β Manual modeβ¦ β From preset β
β Π€ΡΠ΅ΠΊΠ²Π΅Π½ΡΠΈΡΡΠΊΠΈ ΡΠ»ΠΎΡ β Which slot β¦ β 0 (automatic) β
β Π’ΡΠ°Π½ΡΠΌΠΈΡΠ΅Ρ ΡΠΊΡΡΡΠ΅Π½ β Turning thiβ¦ β On β
β Override Duty Cycle β Ignores theβ¦ β ΠΡΠΊΡΡΡΠ΅Π½ β
β ΠΠ³Π½ΠΎΡΠΈΡΠΈ MQTT β Drop packetβ¦ β Off, until you set a duty-cycle-limited region β
β ΠΠΎΠ·ΠΈΡΠΈΠ²Π°Π½ Π·Π° MQTT β Allow your β¦ β ΠΡΠΊΡΡΡΠ΅Π½ β
β ΠΠΎΡΠ°ΡΠ°ΡΠ΅ ΠΏΡΠΈΡΠ΅ΠΌΠ½ΠΈΠΊΠ° β Extra receiβ¦ β ΠΡΠΊΡΡΡΠ΅Π½ β
β PA fan disabled β Turn off thβ¦ β ΠΡΠΊΡΡΡΠ΅Π½ β
ββββββββββββββββββββββββββββββββββββ΄βββββββββββββββ΄βββββββββββββββββββββββββββββββββββββββββββββββββ
Some regions are amateur-radio allocations whose presets only licensed operators may use. On firmware 2.8 or newer the app knows which regions those are and grays the whole Presets list out until Licensed amateur radio (Ham) is turned on for the node you are configuring; the text under the field says so while it is grayed out.
β β οΈ Important: Operating without the correct region may violate local radio regulations. See the
β region configuration guide on
β meshtastic.org for details.
Modem Presets
The Lite, Narrow, Medium Turbo, and Tiny presets need firmware 2.8 or newer β the app hides them on older radios.
β π‘ Tip: The SNR Limit values are negative on purpose. LoRa can decode signals below the noise
β floor, so a more-negative limit means the preset tolerates a weaker, noisier signal (more range).
β See How the Signal Meter
β Works
β for the full explanation.
ββββββββββββββββββββββ¬ββββββββββ¬ββββββββββββ¬ββββββββββββ¬ββββββββββββββββββββββββββββββββββββββββββββ
β Preset β Range β ΠΡΠ·ΠΈΠ½Π° β SNR Limit β Best For β
ββββββββββββββββββββββΌββββββββββΌββββββββββββΌββββββββββββΌββββββββββββββββββββββββββββββββββββββββββββ€
β Short Turbo β ~1 km β 21.9 kbps β β7.5 dB β Dense urban with line-of-sight; data-heaβ¦ β
β Short Fast β ~3 km β 10.9 kbps β β7.5 dB β Urban neighborhoods; buildings within a β¦ β
β Short Slow β ~5 km β 6.25 kbps β β10 dB β Suburban short-range; moderate building β¦ β
β Medium Fast β ~5 km β 3.52 kbps β β12.5 dB β Suburban areas; moderate building density β
β Medium Slow β ~8 km β 1.95 kbps β β15 dB β Suburban/rural; moderate range with slowβ¦ β
β Long Turbo β ~10 km β 1.34 kbps β β12.5 dB β Similar range to Long Fast but with 500 β¦ β
β Long Fast β ~10 km β 1.1 kbps β β17.5 dB β General use (default) β balanced range aβ¦ β
β Long Moderate β ~20 km β 0.34 kbps β β17.5 dB β Rural with some terrain; occasional use β
β Lite Fast β ~5 km β 1.76 kbps β β12.5 dB β EU 866 MHz SRD band (125 kHz BW); comparβ¦ β
β Lite Slow β ~10 km β 0.98 kbps β β15 dB β EU 866 MHz SRD band (125 kHz BW); comparβ¦ β
β Narrow Fast β ~5 km β 2.28 kbps β β10 dB β EU 868 MHz band (62.5 kHz BW); avoids inβ¦ β
β Narrow Slow β ~10 km β 1.30 kbps β β12.5 dB β EU 868 MHz band (62.5 kHz BW); comparablβ¦ β
β Medium Turbo β ~5 km β 7.0 kbps β β12.5 dB β Like Medium Fast but with 500 kHz bandwiβ¦ β
β Tiny Fast β ~10 km β 0.68 kbps β β7.5 dB β Amateur bands that cap occupied bandwidtβ¦ β
β Tiny Slow β ~20 km β 0.33 kbps β β10 dB β Same band restrictions as Tiny Fast, lonβ¦ β
β ~~Long Slow~~ β ~30 km β 0.18 kbps β β20 dB β β οΈ Deprecated β still selectable but mayβ¦ β
β ~~Very Long Slow~~ β ~40+ km β 0.09 kbps β β20 dB β β οΈ Deprecated β still selectable but mayβ¦ β
ββββββββββββββββββββββ΄ββββββββββ΄ββββββββββββ΄ββββββββββββ΄ββββββββββββββββββββββββββββββββββββββββββββ
β βΉοΈ Note: This table uses the common short names. The app's Presets dropdown lists the raw
β firmware names instead β T383838SHORT_FAST, T383838LONG_FAST, T383838LITE_FAST, T383838NARROW_FAST, and so on. Local Mesh
β Discovery shows the same presets as Long Fast and Short Turbo.
Choosing a Modem Preset
The modem preset controls the fundamental tradeoff between range and data rate:
β’ Slower presets use more spreading, making signals decodable at weaker signal levels (lower SNR limit). This means longer range but fewer bytes per second.
β’ Faster presets pack more data per transmission but require a stronger signal to decode.
Practical guidance:
β’ Urban mesh (many nodes, short distances): Use Long Fast (default) or Short Fast. Higher speed means less airtime congestion when many nodes share the channel.
β’ Rural/sparse mesh (few nodes, long distances): Use Long Moderate. Range matters more than speed when nodes are far apart.
β’ EU 866/868 MHz regulatory compliance: Use Lite Fast, Lite Slow, Narrow Fast, or Narrow Slow β these are optimized for the EU SRD/868 MHz bands with narrower bandwidths.
β’ Fixed infrastructure links: Use Short Turbo or Long Turbo for dedicated point-to-point links with good antennas and line-of-sight.
β’ Mixed environments: Stick with Long Fast β it's the community default and ensures compatibility with others in your area.
All nodes on the same channel must use the same modem preset. Nodes with mismatched presets cannot communicate even if they share the same frequency and encryption key.
The range estimates in the Modem Presets table assume flat terrain and modest antennas. Elevation advantage (hilltop, rooftop) dramatically increases effective range. A well-placed Router with Long Fast can often outperform a ground-level node with Long Slow.
ΠΠΎΠ΄Π΅ΡΠ°Π²Π°ΡΠ° ΠΏΡΠΈΠΊΠ°Π·Π°
On Settings β Device configuration β Display. These control the radio's own screen, not the app's.
βββββββββββββββββββββββββββββ¬βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Setting β ΠΠΏΠΈΡ β
βββββββββββββββββββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β ΠΠΊΡΠ°Π½ ΡΠΊΡΡΡΠ΅Π½ Π·Π° β How long the display stays lit before sleeping β
β Carousel interval β How often the radio cycles between screens on its own β
β Display mode β Screen layout/density used by the firmware β
β Display units β Metric or Imperial on the radio's screen β
β Use 12h clock format β Show the radio's clock as 12-hour rather than 24-hour β
β Bold Heading β Draw the screen's heading text in bold β
β Flip screen β Rotate the display 180Β° for an inverted mounting β
β OLED type β Auto, SSD1306, SH1106, SH1107 β
β Wake on tap or motion β Light the screen when the radio is tapped or moved β
β Compass orientation β Rotation offset for the compass rose (0Β°, 90Β°, 180Β°, 270Β°) β
β Π£Π²Π΅ΠΊ ΡΡΠΌΠ΅ΡΠ°Π²Π°ΡΡΠ΅ Π½Π° ΡΠ΅Π²Π΅Ρ β Locks the compass rose north-up instead of rotating it with your heβ¦ β
βββββββββββββββββββββββββββββ΄βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
ΠΠΎΠ΄Π΅ΡΠ°Π²Π°ΡΠ° ΠΏΠΎΠ·ΠΈΡΠΈΡΠ΅
On Settings β Device configuration β Position.
β β οΈ Important: Saving this screen always reboots the radio.
ββββββββββββββββββββββββββββββββββββ¬ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Setting β ΠΠΏΠΈΡ β
ββββββββββββββββββββββββββββββββββββΌββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β GPS Mode (Physical Hardware) β Three-state: GPS enabled, disabled, or not present. Not a siβ¦ β
β GPS Polling Interval β How often the radio asks its GPS for a fix β
β ΠΠ½ΡΠ΅ΡΠ²Π°Π» Π΅ΠΌΠΈΡΠΎΠ²Π°ΡΠ° β How often the position is shared with the mesh β
β ΠΠ°ΠΌΠ΅ΡΠ½ΠΎ ΠΏΠΎΠ·ΠΈΡΠΈΠΎΠ½ΠΈΡΠ°ΡΠ΅ β Broadcast based on movement rather than purely on the clock β
β Smart Interval β With Smart Position on, the shortest gap between broadcasts β
β Smart Distance β With Smart Position on, how far you must move before broadcaβ¦ β
β Π€ΠΈΠΊΡΠ½Π° Π»ΠΎΠΊΠ°ΡΠΈΡΠ° β Use a manually entered latitude, longitude and altitude instβ¦ β
β ΠΠ°ΡΡΠ°Π²ΠΈΡΠ΅ ΠΏΠΎΠ·ΠΈΡΠΈΡΠ΅ β A group of toggles choosing which fields ride along with a pβ¦ β
β GPS EN / Receive / Transmit GPIO β Advanced: the pins the GPS module is wired to β
ββββββββββββββββββββββββββββββββββββ΄ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
ΠΠΎΠ΄Π΅ΡΠ°Π²Π°ΡΠ° Π½Π°ΠΏΠ°ΡΡΠ°
On Settings β Device configuration β Power.
βββββββββββββββββββββββββββββββββ¬ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Setting β ΠΠΏΠΈΡ β
βββββββββββββββββββββββββββββββββΌββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β Enable power saving mode β Let the radio sleep aggressively between activity β
β Shutdown on power loss β Power the device down after external power disappears β
β Super deep sleep duration β How long the deepest sleep state lasts β
β Minimum wake time β The shortest time the radio stays awake once woken β
β Wait for Bluetooth duration β How long to wait for a phone to connect before sleeping β
β ADC multiplier override β Turn on a manual correction for battery-voltage readings β
β ADC multiplier override ratio β The correction factor itself, used only when the override is on β
β Battery INA_2XX I2C address β Address of an external INA-series power sensor, if fitted β
βββββββββββββββββββββββββββββββββ΄ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
ΠΠΎΠ½ΡΠΈΠ³ΡΡΠ°ΡΠΈΡΠ° ΠΌΡΠ΅ΠΆΠ΅
On Settings β Device configuration β Network, on radios with Wi-Fi or Ethernet.
β β οΈ Warning: Turning on Wi-Fi enabled or Ethernet enabled ends the Bluetooth connection between
β your phone and the radio. Reconnect over the network afterwards from the
β Connections
β screen, or turn Wi-Fi off again from the radio's own screen or over USB. Saving this screen also
β always reboots the radio.
βββββββββββββββββββββββββββββββββββββ¬βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Setting β ΠΠΏΠΈΡ β
βββββββββββββββββββββββββββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β Wi-Fi enabled β Enable the Wi-Fi radio (ESP32 radios) β
β SSID β Network name to connect to. Appears only once Wi-Fi enabledβ¦ β
β ΠΠΎΠ·ΠΈΠ½ΠΊΠ° β Network password β
β Ethernet enabled β Use a wired connection on hardware that has one β
β IPv4 mode β DHCP, or a static address configured with the four fields tβ¦ β
β Wi-Fi IP / Subnet / Gateway / DNS β The static address, only used when IPv4 mode is static β
β UDP broadcasting β Share mesh traffic with other nodes over the local network β
β NTP server β Time synchronization server β
β rsyslog server β Remote logging server β
βββββββββββββββββββββββββββββββββββββ΄βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
ΠΠ»ΡΡΡΡ ΠΏΠΎΠ΄Π΅ΡΠ°Π²Π°ΡΠ°
On Settings β Device configuration β Bluetooth, on radios with Bluetooth.
β β οΈ Important: Saving this screen always reboots the radio.
βββββββββββββββββββββ¬βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Setting β ΠΠΏΠΈΡ β
βββββββββββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β Bluetooth enabled β Enable/disable BLE radio β
β Pairing mode β Fixed PIN, Random PIN, or No PIN β
β Fixed PIN β PIN code for pairing. Must be exactly six digits β the field rejects anythiβ¦ β
βββββββββββββββββββββ΄βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
Π‘ΠΈΠ³ΡΡΠ½ΠΎΡΠ½Π° ΠΏΠΎΠ΄Π΅ΡΠ°Π²Π°ΡΠ°
On Settings β Security. The screen is grouped into cards: Packet authenticity, Direct Message Key (your node's key pair), Admin Keys, Logs, and Administration.
β β οΈ Important: Saving this screen always reboots the radio.
βββββββββββββββββββββββββββββ¬βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Setting β ΠΠΏΠΈΡ β
βββββββββββββββββββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β ΠΠ°Π²Π½ΠΈ ΠΊΡΡΡ β Your node's public key (read-only) β
β Admin Key β Keys permitted to administer this node remotely β up to three β
β ΠΡΠΈΠ²Π°ΡΠ½ΠΈ ΠΊΡΡΡ β Your node's private key (handle securely). Shown redacted when you β¦ β
β Regenerate Private Key β Issues a new keypair for this node, behind a confirmation. Every peβ¦ β
β ~~Admin Channel Enabled~~ β β οΈ Removed β now configured automatically when an admin key is set β
β Serial console β Serial console over the Stream API β
β Debug log API enabled β Output live debug logging over serial, and view and export positionβ¦ β
β Managed Mode β Restrict non-admin channel changes. Only selectable once an Admin Kβ¦ β
β Backup Keys β Save an encrypted backup of the node's keys on this phone (Android β¦ β
β Restore Keys β Write the backed-up keys back to the node (available once a backup β¦ β
β Delete Key Backup β Remove the stored key backup from this phone β
β Protection level β How unsigned or relayed packets are treated: Strict β Require autheβ¦ β
βββββββββββββββββββββββββββββ΄βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
Lockdown Mode
Lockdown encrypts the device's storage and requires a passphrase for each connection. It needs
supporting firmware; the row does not appear otherwise.
Enabling it asks you to set and confirm a passphrase, and to acknowledge that **it locks the debug
(SWD) port on hardware that supports locking**. You can turn lockdown off again at any time with
the passphrase, and a full device erase restores the hardware regardless.
Alongside the passphrase you set the limits that end a session automatically:
βββββββββββββββββββββββββ¬βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Field β What it does β
βββββββββββββββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β Boots remaining β How many device boots the unlocked state survives β
β Hours until expiry β Wall-clock lifetime of the unlocked state β
β Session cap (minutes) β A per-boot uptime cap on the unlocked state. 0, the default, means no cβ¦ β
βββββββββββββββββββββββββ΄βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
Once active, the row reads Active β storage encrypted, this connection authenticated when
unlocked, or Active β enter your passphrase to unlock this connection when not. Lock Now
ends the current session immediately. Repeated wrong passphrases are rate-limited with a
back-off before you can try again.
β β οΈ Warning: There is no passphrase recovery. Losing it means erasing the device to get it back,
β which destroys its keys, channels and settings.
Related Topics
β’ Settings β Modules & Admin β optional feature modules and device administration
β’ Signal Meter β how modem presets affect signal quality thresholds
β’ LoRa configuration β detailed LoRa settings reference on meshtastic.org
β’ Initial configuration β region setup guide on meshtastic.org
Served by rngit 1.5.4 - Generated in 0.31s